Scale: Improve docs of prop digits in other places
authorDaniel Boles <dboles@src.gnome.org>
Sun, 19 Feb 2017 08:37:51 +0000 (08:37 +0000)
committerDaniel Boles <dboles@src.gnome.org>
Sun, 19 Feb 2017 08:39:31 +0000 (08:39 +0000)
There were places still implying that it was only used for display.

gtk/gtkscale.c

index b2e4e19da630fe9349879ffde198f114bfe9298b..45e51c1691ae01f8223aca99454b119c8514d23a 100644 (file)
@@ -759,10 +759,17 @@ gtk_scale_class_init (GtkScaleClass *class)
                   G_TYPE_STRING, 1,
                   G_TYPE_DOUBLE);
 
+  /**
+   * GtkScale:digits:
+   *
+   * The number of decimal places to which the value is rounded when it is
+   * changed. This also sets the number of digits shown in the displayed value
+   * when using the default handler for the #GtkScale:format-value signal.
+   */
   properties[PROP_DIGITS] =
       g_param_spec_int ("digits",
                         P_("Digits"),
-                        P_("The number of decimal places that are displayed in the value"),
+                        P_("The number of decimal places to which the value is rounded"),
                         -1, MAX_DIGITS,
                         1,
                         GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY);
@@ -1118,9 +1125,10 @@ gtk_scale_set_digits (GtkScale *scale,
  * gtk_scale_get_digits:
  * @scale: a #GtkScale
  *
- * Gets the number of decimal places that are displayed in the value.
+ * Gets the number of decimal places to which the value is rounded on change.
+ * This number is also used by the default #GtkScale:format-value handler.
  *
- * Returns: the number of decimal places that are displayed
+ * Returns: the number of decimal places
  */
 gint
 gtk_scale_get_digits (GtkScale *scale)